Releases the memory occupied by a region.

void DisposeRgn (
     rgn
);

rgn

A handle to the region to dispose. This handle should be a region handle returned by the NewRgn function.

DISCUSSION

Use DisposeRgn only after you are completely through with a region.

SPECIAL CONSIDERATIONS

The DisposeRgn function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)